package com.fy.fyspace.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.fy.fyspace.model.entity.PictureHotness;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 图片热度Mapper接口
 * 设计模式：数据访问对象模式
 * 作用：提供图片热度数据的数据库操作接口
 */
@Mapper
public interface PictureHotnessMapper extends BaseMapper<PictureHotness> {
    
    /**
     * 批量插入或更新图片热度数据
     * 
     * @param hotnessList 热度数据列表
     * @return 影响行数
     */
    int batchInsertOrUpdate(@Param("list") List<PictureHotness> hotnessList);
    
    /**
     * 根据图片ID列表查询热度数据
     * 
     * @param pictureIds 图片ID列表
     * @return 热度数据列表
     */
    List<PictureHotness> selectByPictureIds(@Param("pictureIds") List<Long> pictureIds);
    
    /**
     * 查询所有热度数据（限制数量）
     * 
     * @param limit 限制数量
     * @return 热度数据列表
     */
    List<PictureHotness> selectAllWithLimit(@Param("limit") int limit);
    
    /**
     * 更新历史分数
     * 
     * @param pictureId 图片ID
     * @param yesterdayScore 昨日分数
     * @param lastWeekScore 上周分数
     * @param lastMonthScore 上月分数
     * @return 影响行数
     */
    int updateHistoricalScores(@Param("pictureId") Long pictureId,
                               @Param("yesterdayScore") java.math.BigDecimal yesterdayScore,
                               @Param("lastWeekScore") java.math.BigDecimal lastWeekScore,
                               @Param("lastMonthScore") java.math.BigDecimal lastMonthScore);
} 